home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / tcp_ip / docs / cmdshlp8 / attach < prev    next >
Encoding:
Text File  |  1996-04-23  |  8.1 KB  |  186 lines
  1.  
  2. attach
  3.  
  4.  
  5. Attaching the ports on a PC
  6.  
  7.     attach <hw_type> <io_addr> <vector> <mode> <label> <bufsize> <mtu>
  8.     [<speed>]
  9.  
  10.      Configure and attach a hardware interface to the system. Detailed
  11. instructions for each driver are in the Attach Commands chapter.  An
  12. easy way to obtain a summary of the parameters required for a given
  13. device is to issue a partial attach command (e.g., attach asy). This
  14. produces a message giving the complete command format.
  15.  
  16.         <hw_type> is the kind of I/O device being attached to the
  17.                 system.  Choices include asy, kiss, packet, netrom, scc...
  18.         <io_addr> is the base address of the control registers for the
  19.                   device.
  20.         <vector>  is the interrupt vector number.  Both the address
  21.                and the vector must be in hexadecimal.  You may put "0x" in
  22.                front of the numbers, but they will be interpreted in
  23.                hexadecimal even without the prefix.
  24.         <mode> controls how IP datagrams are to be encapsulated in
  25.                the device's link level protocol.
  26.                Choices include ax25, slip, pkiss, nrs, ppp...
  27.  
  28.      slip      Encapsulates IP datagrams directly in SLIP frames
  29.      without a link header.  This is for operating point-to-point
  30.      lines and is compatible with 4.2BSD UNIX SLIP.
  31.  
  32.      ax25      Similar to slip, except that an AX.25 header and a KISS
  33.      TNC control header are added to the front of the datagram before
  34.      SLIP encoding.  Either UI (connectionless) or I (connection-
  35.      oriented) AX.25 frames can be used.
  36.         
  37.      pkiss     Similar to ax25, except that packets are checksummed and
  38.      the interfaced devices are queried (polled) regularly for data.
  39.      Used by G8BPQ polled-kiss software.
  40.  
  41.      nrs       Similar to ax25, except that packets are transmitted only
  42.      when permitted by flow-control signals.  Typical of Netrom node stacks
  43.      using Netrom serial protocol.
  44.  
  45.      ppp       Similar to slip, except the protocol is different and
  46.      typically is capable of compression.
  47.  
  48.         <label>   defines the name by which the interface will be
  49.         known to various commands, such as "connect", "route",
  50.         "trace", etc.
  51.         
  52.         <bufsize> For ASYNCHRONOUS PORTS, specifies the size of the
  53.         ring buffer in bytes to be statically allocated to the
  54.         receiver; incoming bursts larger than <bufsize> may cause data
  55.         to be lost.
  56.         For ETHERNET, specifies how many PACKETS may be queued in the
  57.         receive queue at one time.  Excess packets will be discarded
  58.         as they are received.  This is useful to prevent the system
  59.         from running out of memory should another node suddently
  60.         develop a case of diarrhea.
  61.         
  62.         <mtu>     is the Maximum Transmission Unit size in bytes.
  63.         See the section 'Of PACLEN, MTU, MSS, and More' in the JNOS40
  64.         Configuration Manual for a discussion of the effect of MTU on
  65.         system performance.
  66.  
  67.     attach asy <io_addr> <vector> <mode> <label> <bufsize> <mtu>
  68.     [<speed>] [<flags>]
  69.  
  70.      Configure and attach a standard PC asynchronous I/O port using
  71. the National 8250, 16450, or 16550(A) chip or equivalent to the system,
  72. where:
  73.  
  74.         <io_addr> is the comm port address; e.g., com1 = 0x3f8
  75.         <vector>  is the comm port IRQ value.  If it is suffixed by "_C"
  76.                   then the interrupt service routine for this port is
  77.                   chained to the server list for this IRQ.
  78.         <mode>    one of: slip, ax25, ppp, pkiss, nrs
  79.         <flags>   string of characters, specifying options:
  80.                   c - do BPQ checksumming of ax.25 kiss packets
  81.                   v - do Van Jacobson TCP header compression on slip intfc
  82.                   f - force use of 16550a uart features (eg UM16C550 chip)
  83.                   fN - set 16550a trigger level to N (1,4,8, or 14. Default=4)
  84.                   n - use NRS-CTS protocol on nrs interface
  85.         
  86.                   Flag  for_mode  #define_needed_in_config.h
  87.                   c     ax25      AX25 and POLLEDKISS
  88.                   v     slip      SLIP and VJCOMPRESS
  89.                   n     nrs       NRS
  90.                   f     (any)     ASY
  91.  
  92.     attach axip <iface> <mtu> <ipaddress> [<callsign>]
  93.  
  94.      Create a RFC1226 compatible AX.25 frame encapsulator for
  95. transmission of AX.25 frames over the IP.  This command is used to
  96. establish a point-to-point AX.25 'tunnel' between two systems.
  97.  
  98.  
  99.         <iface>   will be the name of the new interface,
  100.         <mtu>     is the maximum transmission unit for the interface,
  101.         <ipaddress> is the address of the system on the other side of
  102.         the 'tunnel,
  103.         <callsign> is the optional AX.25 callsign this station is
  104.         listening on for frames to digipeat. Note that if you want
  105.         cross-tunnel digipeating to work, each attached axip interface
  106.         should listen to a different callsign.  These should also be
  107.         different from other callsigns used on this station.
  108.           
  109.           attach axip axip1 256 44.26.1.19 WG7J-15
  110.           
  111.           
  112.     attach kiss <asy_iface_label> <port> <label> [mtu]
  113.  
  114.      Attach a second kiss interface on the serial port. This command
  115.      allows the use of multiport TNCs.  The first port should be attached
  116.      by a prior "attach asy ..." command with <mode> set to ax25 or pkiss.
  117.      Use pkiss if G8BPQ polled kiss mode is desired.
  118.      
  119.      
  120.         <asy_iface_label>   is the name of the serial port interface.
  121.         <port>    is the port number (1-15) to use, and probably
  122.                   should be 1. (the original asy port is automatically
  123.                   port 0 !)
  124.         <label>   is the name for this second kiss port.
  125.         <mtu>     is an optional mtu, if different from the mtu on the
  126.                   first kiss port.
  127.  
  128.           # Attach a dualport tnc in kiss mode.
  129.           # Ports are labelled 'port1' and 'port2'
  130.           
  131.           # Attach a PC asynch port (com1 in this example)
  132.           
  133.           attach asy 03f8 4 ax25 port1 512 256 9600
  134.           
  135.           # Attach the second port on the multiport tnc
  136.           
  137.           attach kiss port1 1 port2
  138.           
  139.     
  140.     attach netrom
  141.  
  142.      This makes available a pseudo interface to enable NET/ROM
  143.      operations.  This command is automatically executed when the
  144.      netrom server is started with the 'start netrom' command.
  145.  
  146.  
  147.     attach packet <softintr#> <iface_label> <maxqueue> <mtu> [ipaddress]
  148.  
  149.      Driver for use with separate software "packet drivers" which
  150.      conform to the FTP Software, Inc., Software Packet Driver
  151.      specification.  See the Crynwr (TM) packet driver collection
  152.      if your hardware (e.g. ethernet card) came without a packet
  153.      driver.  [ipaddress] is an optional ip address for the interface.
  154.      If not set, the system 'ip address' will be used.
  155.  
  156.      Example: attach packet 0x7e eth0 5 1500
  157.  
  158.      
  159.     attach scc
  160.  
  161.      PE1CHL driver for generic Z8530 cards.  See scc.c source for
  162.      details.  This driver is also used for DRSI cards.
  163.  
  164.  
  165.     attach bpq init <vec> <stream>
  166.     attach bpq <port> <label> [<mtu> [<callsign>]]
  167.  
  168.      The Jnos BPQ driver allows Jnos to attach interfaces directly
  169.      to bpqcode without having to use the packet driver interface and
  170.      the nodedrv4.com TSR. Jnos will talk to bpqcode using the bpq_host
  171.      interrupt code in version 4.00 and up of bpqcode. This eliminates
  172.      the extra memory and processing time used by nodedrv4.com to send
  173.      packets between Jnos and bpqcode.
  174.  
  175.      The "attach bpq init" sub-command attaches the bpq_host TSR driver,
  176.      which is accessed via software interrupt <vec> (in hex) for BPQ
  177.      stream <stream> (in decimal).  "attach bpq init" may only be called
  178.      once.
  179.  
  180.      The second form of the "attach bpq" sub-command is called once per
  181.      <port>. It associates a BPQ <port> number with an interface name
  182.      <label>. <mtu> may not exceed 256, and defaults to the ax.25 paclen
  183.      value. <callsign> defaults to the ax25 mycall value, and establishes
  184.      the callsign used by this BPQ port.
  185.  
  186.